home *** CD-ROM | disk | FTP | other *** search
/ Macwelt 1 / Macwelt DVD 1.toast / Web-Publishing / HTML-Editoren / Alpha ƒ / Help / Internet Config < prev    next >
Encoding:
Text File  |  2000-11-30  |  20.6 KB  |  534 lines
  1.  
  2. Internet Config Help
  3.  
  4.                                                version: 0.1.3
  5.                                                created: 12/27/95 {11:56:24 am}
  6.                                            last update: 11/30/00 {07:44:52 pm}
  7.  
  8.  
  9. Internet Config is a freeware utility that holds system-wide Internet
  10. preferences, especially preferences that might be accessed by more than one
  11. application.  For example, Internet Config stores pointers to helpers for
  12. web services, ftp, etc.
  13.  
  14. Alpha supports Internet Config in the following ways:
  15.  
  16. • Command-clicking on any text causes Alpha to try find a URL anywhere near
  17.   where you click.  If Alpha finds one it sends it to Internet Config which
  18.   passes it to the right helper application.  Unfortunately, this feature
  19.   is rather buggy.  Whenever there is a colon nearby where you click Alpha
  20.   usually thinks there is a URL, although there is not, and sends it to
  21.   Internet Config.  This bug prevents command-double-clicking to work
  22.   properly.
  23.  
  24. • The Internet Config menu allows either Internet Config itself, or several
  25.   of it's internet helpers, to be started.
  26.  
  27. • Alpha can get the helper application for http and ftp from Internet Config. 
  28.   Checking the box 'Synchronise with Internet Config' in the preferences
  29.   dialog "Config --> Preferences --> WWW" will make Alpha get the helper
  30.   for http and ftp from Internet Config every time Alpha is launched.
  31.  
  32.  
  33.           Activating the Internet Config menu
  34.  
  35.  
  36. The menu is activated in the "Config --> Preferences --> Features…" dialog. 
  37. Check the checkbox 'Internet Config Menu' among the global menus.
  38.  
  39.  
  40.                URLs submenu
  41.  
  42. The 'URLs' submenu allows you to store a few commonly used URLs and to launch
  43. them, regardless of what helper they are directed to.  You add a URL to the
  44. menu by using 'Add' and specifying a name and the URL.
  45.  
  46. Some examples:
  47.  
  48. Alpha's home page                   http://alpha.olm.net/
  49. Alpha's ftp                         ftp://alpha.olm.net/pub/
  50. Ftp requiring userid and password   ftp://userid:passwd@some.site.edu/path/
  51. Mail to someone                     mailto:somebody@somewhere.net
  52.  
  53. "View" opens a window with a list of all URLs in the menu, so you can see how
  54. they are defined.
  55.  
  56. "Remove" lets you remove a URL from the menu.
  57.  
  58.  
  59.                Main Internet Config menu
  60.  
  61.  
  62.     Pick Url            
  63.  
  64. To pick a URL from the URL submenu.
  65.  
  66.     Go To               
  67.  
  68. Launches Internet Config
  69.  
  70.     Help                
  71.  
  72. Opens this file
  73.  
  74.     Web Browser         
  75.  
  76. Launches the web browser specified as your http helper in Internet Config
  77.  
  78.     News Client         
  79.  
  80. Launches the news reader specified as your news helper in Internet Config
  81.  
  82.     Mail Client         
  83.  
  84. Launches the mail program specified as your mailto helper in Internet
  85. Config
  86.  
  87.     Ftp Client          
  88.  
  89. Launches the ftp client specified as your ftp helper in Internet Config
  90.  
  91.     Gopher Client       
  92.  
  93. Launches the gopher client specified as your gopher helper in Internet
  94. Config
  95.  
  96.     Telnet Client       
  97.  
  98. Launches the telnet client specified as your telnet helper in Internet
  99. Config
  100.  
  101.     Finger              
  102.  
  103. To finger someone using Peter Lewis's 'Finger' program.  Specify who to
  104. finger and the result from Finger will be display in a window in Alpha.
  105.  
  106.     Telnet              
  107.  
  108. To open a telnet connection.  This function works with NSCA Telnet, Better
  109. Telnet, and Nifty Telnet.
  110.  
  111.     Resolve Url         
  112.  
  113. Sends the selected text to Internet Config trying to resolve the selection
  114. and send it to the appropriate helper.  View Html File
  115.  
  116. Sends the current window to your web browser.  (This is the same function
  117. as 'Send File to Browser' in the HTML menu.)
  118.  
  119. Below is the documentation for using the Internet Config application.
  120.  
  121.           
  122.     ------------------------------------------------------------------------
  123.  
  124.  
  125.           Internet Config User Documentation
  126.  
  127.  
  128. Created by <ic@stairways.com>
  129.  
  130.  
  131.                Introduction
  132.  
  133. The Internet Configuration System was designed to make your life easier by
  134. reducing the number of times which you need to enter your Internet
  135. preferences into the various preferences windows of all your Internet
  136. applications.
  137.  
  138. For example, currently you need to enter your email address into many common
  139. Macintosh Internet applications, for example Claris Emailer, NewsWatcher and
  140. Anarchie.  The goal of the system was to get each of these applications to
  141. get this information from one common place and to give you a tool to edit
  142. these common preferences.
  143.  
  144. It is important to realise that applications will have to be modified to take
  145. advantage of the Internet Configuration System.  It will take some time for
  146. all applications to be revised and until then you will have to enter your
  147. preferences in those applications in the traditional manner.
  148.  
  149.  
  150.           Getting Started
  151.  
  152.                System Requirements
  153.  
  154. The Internet Configuration system requires System 7 or later, and Component
  155. Manager.
  156.  
  157. If you've never heard of Component Manager, that's OK. It's installed as part
  158. of System 7.1 and above, and as part of QuickTime.  So chances are that it's
  159. already on your computer.  You can just run IC and it will tell you if you
  160. don't have it installed.
  161.  
  162. If you do not have System 7 or Component Manager installed, you can not use
  163. this version of IC. IC 1.4 and below do not have these requirement.  You can
  164. FTP old versions of IC from the IC home site.
  165.  
  166. IC does not require MacTCP or Open Transport, and it makes sense to install
  167. it even if you're not directly connected to the Internet.
  168.  
  169.  
  170.                Quick Start
  171.  
  172.  
  173. Run the Internet Config application.  If it asks you whether you want to
  174. install the Internet Config Extension, say that you do.  Click on each button
  175. in the Main window in turn, enter appropriate preferences.  [If you don't
  176. understand an item, turn on Balloon Help or look it up in the reference
  177. section at the end of this document.]  Save and quit.
  178.  
  179. It is important to realise that you don't have to set every preference.  For
  180. example, if you don't use WAIS, there's no need to set your WAIS Gateway
  181. preference.  The preferences that you most probably want to set (grouped by
  182. window) are:
  183.  
  184.    • Personal
  185.         o Real Name, eg "Santa Claus"
  186.         o Organisation, eg "Happy Holidays, Inc"
  187.         o Signature, to be appended to email and news messages that you
  188.           send.
  189.    • Email
  190.         o Email Address, eg "santa@north-pole.org"
  191.         o Email Account, , eg "santa@pop.north-pole.org"
  192.         o Email Password, the password for the above account
  193.         o SMTP Host, eg "mail.north-pole.org"
  194.    • News
  195.         o NNTP Host, eg "nntp.north-pole.org"
  196.    • WWW
  197.         o Home Page, eg "http://www.north-pole.org/MyHomePage.html"
  198.         o Search Page, eg "www.alta-vista.digital.com"
  199.    • File Transfer
  200.         o Download Folder
  201.    • Helpers
  202.         o Set the "http", "https", and "file" helper to your preferred web
  203.           browser.
  204.         o Set the "ftp" helper to your preferred FTP client.
  205.         o Set the "mailto" helper to your preferred email application.
  206.  
  207.  
  208.           Parts of the System
  209.  
  210.  
  211. The system contains 3 important parts:
  212.  
  213.    • Internet Config application
  214.    • Internet Config Extension
  215.    • the Internet Preferences preferences file
  216.  
  217. The most important is the Internet Config application.  When you run this
  218. application it creates and installs the Internet Config Extension (in the
  219. Extensions folder) and creates a default Internet Preferences file (in the
  220. Preferences folder).
  221.  
  222. For programmers there is a separate distribution that contains all the files
  223. needed to make an Internet Config aware program.
  224.  
  225.  
  226.           Internet Configuration Application Reference
  227.  
  228.  
  229. The Internet Configuration application works much like any other Macintosh
  230. application.  The basic document for the application is an Internet
  231. Preferences preference file.
  232.  
  233. Unlike most Macintosh applications, when you launch the Internet
  234. Configuration application it does not create a new untitled document. 
  235. Instead it opens the Internet Preferences file in your Preferences folder
  236. (creating it if it isn't there).  This is useful because, unless you're doing
  237. something strange, you need never use the standard document features (New,
  238. Open, Save, etc).  Instead all you need to do is launch the application,
  239. modify your preferences and then quit with saving.
  240.  
  241.  
  242.           Menus
  243.  
  244.  
  245. The following commands are available on the Apple menu:
  246.  
  247. About Internet Config
  248.  
  249. This opens the about box.  Do not bother looking for magical Easter Eggs; we
  250. were much too busy to mess with that sort of thing.  You can, however, click
  251. on the blue underlined text to view the latest IC FAQ or mail the Internet
  252. Config support address.
  253.  
  254. The following commands are available on the File menu:
  255.  
  256.    • New
  257.    • Open
  258.    • Open Internet Preferences
  259.    • Close
  260.    • Save
  261.    • Save as
  262.    • Quit
  263.  
  264. These commands work as you would expect in a normal Macintosh application,
  265. with one exception.  The application can only have one preferences file open
  266. at any point in time, so when you open a new preferences file, by Open or New
  267. , the previous one is automatically closed.  The Open Internet Preferences
  268. command opens the default set of Internet Preferences (in your Preferences
  269. folder), which is useful if you accidentally close the window.
  270.  
  271. The Edit menu is used for editing text.
  272.  
  273. The Sets menu allows you to create multiple independent sets of preferences
  274. for different users of the computer, or different Internet personalities of
  275. the same user.  The Sets menu contains the following commands:
  276.  
  277.    • Duplicate
  278.    • Rename
  279.    • Delete
  280.  
  281. The Duplicate command allows you to create a new set by duplicating the
  282. current set.  The Rename command allows you to give a new name to the current
  283. set.  The Delete command lets you delete the current set.  The remaining
  284. items on the Sets menu allow you to switch between sets.
  285.  
  286. The Extension menu lets you install the Internet Config Extension in your
  287. Extensions folder.  As IC does this when you first launch it, there is rarely
  288. any point to this.  It also allows you to save a copy of the extension
  289. without installing it.
  290.  
  291. The Window menu allows you to open or bring to front any of the configuration
  292. windows.
  293.  
  294. The Help menu (under Mac OS 7.6.1 and earlier, this is on the right side of
  295. the menu bar with a question mark icon) lets you turn on Balloon Help.  The
  296. application has full Balloon Help support.
  297.  
  298.  
  299.           Windows
  300.  
  301.  
  302. The Main window is opened whenever you open a preferences file.  It has 10
  303. buttons (with cutesy colour icons) that let you open the other windows.
  304.  
  305. The Personal window lets you edit all sorts of preferences related to your
  306. person.  These include:
  307.  
  308.    • Real Name -- your real name, as used by news and mail
  309.    • Organisation -- the company etc that you work for, as used by news
  310.    • Quote String -- the string used to precede quoted text, as used by news
  311.      and mail
  312.    • Signature -- a short piece of pithy text added to the end of your mail
  313.      messages and news posting, as used by news and mail
  314.    • Plan -- as used by finger servers
  315.  
  316. The Email window lets you edit preferences related to email. These include:
  317.  
  318.    • Email Address -- address to which you want replies to your mail sent
  319.    • Mail Account -- account from which you wish your mail to be fetched
  320.    • Mail Password -- password for the above
  321.    • Mail Host -- host to which to forward mail (normally the same machine
  322.      as the one that has your mail account)
  323.    • Mail Headers -- any extra headers you want inserted in your outgoing
  324.      mail
  325.    • On New Mail -- a group of preferences that specify what happens when
  326.      new mail arrives
  327.  
  328. The News window lets you edit preferences related to News. These include:
  329.  
  330.    • News Username -- most systems let you read news without one
  331.    • News Password -- most systems let you read news without one
  332.    • NNTP Host -- machine from which to fetch news
  333.    • News Headers -- any extra headers you want inserted in your news
  334.      postings
  335.  
  336. The World Wide Web window lets you edit preferences related to the World
  337. Wide Web. These include:
  338.  
  339.    • WWW Home Page -- a URL for the page you want your web browser to open
  340.      first
  341.    • WWW Search Page -- a URL for the page you want your web browser to use
  342.      as its search page
  343.    • Colour -- various options to configure the default colours for your web
  344.      pages
  345.  
  346. The File Transfer window lets you edit preferences related to the transfer of
  347. files (except file types, which have their own window).  These include:
  348.  
  349.    • Archie Server -- your preferred Archie server
  350.    • Info-Mac Server -- your preferred Info-Mac mirror
  351.    • UMich Server -- your preferred UMich mirror
  352.    • Download Folder -- the place where you want new files to appear
  353.  
  354. Archie is a protocol for searching archive sites looking for files.  There
  355. are a number of Archie servers around the world.  In theory these should all
  356. be the same but sometimes it's useful to use one in preference to another.
  357.  
  358. Info-Mac and UMich are two big archives of Macintosh software.  They are
  359. often very busy and won't let you on.  To get around this you can get files
  360. from other machines that mirror these archives.  Some software will use the
  361. preferences here to automatically route requests to your preferred mirror.
  362.  
  363. The Other Services window is a collection of preferences that didn't fit in
  364. anywhere else.  These include:
  365.  
  366.    • Ph Host -- your preferred Ph server (a standard machine name)
  367.    • Finger Host -- your default finger server
  368.    • Whois Host -- your default whois server
  369.    • Telnet Host -- the default machine for telnet connections
  370.    • FTP Host -- the default machine for FTP connections
  371.    • Gopher Host -- your 'root' gopher server (a standard machine name)
  372.    • WAIS Gateway -- your WAIS gateway (a standard machine name)
  373.    • LDAP -- Stuff related to X.500, see your X.500 docs for more details
  374.  
  375. The Fonts window lets you set your preferred List, Screen and Printer font. 
  376. The List font is used in summary listings, such as mailbox summaries or FTP
  377. directory listings.  The Screen font is used to display monospaced text, such
  378. as the body of mail or news messages.  The Printer font is used to print
  379. monospaced text.
  380.  
  381. The File Mappings window lets you view and edit the table that is used to set
  382. the Macintosh file type and creator of incoming files based on their
  383. extension.  If you don't understand this window then please don't worry. 
  384. We've done our best to set up appropriate defaults.  If you have any problems
  385. with file transfers, then resetting to factory defaults will probably help.
  386.  
  387. The Helpers window lets you view and edit the table that is used to determine
  388. which application to run when a specific URL is accessed.  For example,
  389. ICeTEe uses this table to determine what application to run when you command
  390. click a URL.
  391.  
  392. The Firewalls window lets you configure firewall information.  Most
  393. commercial organisations on the Internet have firewalls that prevent
  394. unauthorised access to the organisation's network from outside.  Sometimes
  395. these firewalls require you to specially configure your Internet
  396. applications.  Internet Config maintains a central copy of this special
  397. configuration for all applications to use.
  398.  
  399.  
  400.           Credits
  401.  
  402. If you find a bug in Internet Config then please forward details to the
  403. official support address for Internet Config.  Please read the Internet
  404. Config FAQ before sending messages to this address.  If you want to discuss
  405. Internet Config in general then we suggest you host that discussion on the
  406. comp.sys.mac.comm newsgroup.
  407.  
  408. The Internet Configuration System was written by Quinn "The Eskimo" and Peter
  409. N Lewis over a period of way too many late nights and weekends.  Certain
  410. important chunks of code were contributed by Marcus Jager and Stuart
  411. Cheshire.  Craig Richmond provided a lot of help sorting out the default MIME
  412. mappings.  Much of the extension to type mapping information was gleaned from
  413. Robin D H Walker's Extension-to-Type mappings file.  Eric Kidd maintains the
  414. Internet Config web site and also gave invaluable insight into the problems
  415. of override components.  John Norstad graciously contributed the resource
  416. fork sanity checking code from his legendary Disinfectant anti-virus utility.
  417.  
  418. We would like to thank all of those on the Internet Config mailing list and
  419. all of the developers who have adopted the system.
  420.  
  421. The entire Internet Config system is public domain and can be redistributed
  422. without restriction.
  423.  
  424. The latest version of Internet Config can be FTPed from the home sites in
  425. Australia and the USA.
  426.  
  427.           Release Notes
  428.  
  429. This section contains information about the various released versions of
  430. Internet Config, in reverse order:
  431.  
  432. IC 2.0 (Feb 1998)
  433.  
  434.    • Internet Config now requires System 7.0 or later, and Component
  435.      Manager.
  436.    • The system now supports multiple separate preferences sets. Multiple
  437.      users can now share the same machine with consummate ease. Existing
  438.      preference files are automatically converted to a new file with a
  439.      single set, "My Settings".
  440.    • User kit now includes a Control Strip module and Location Manager
  441.      module for quickly switching between preference sets.
  442.    • Fixed cosmetic programs under Mac OS 8.0 and later.
  443.    • Added APIs to allow external file systems to access the IC extension
  444.      mapping database.
  445.    • Reworked the programming environment. See the Programming Kit for
  446.      details.
  447.    • Bug fixes and new preference defaults.
  448.  
  449. IC 1.4 (Mar 1997)
  450.  
  451.    • The IC application now supports GURL AppleEvents, routing them to the
  452.      appropriate helper application. This eliminates the need for an IC
  453.      scripting addition for this trivial task.
  454.    • If you do not have a specific helper set for "https" and "file" URLs,
  455.      IC will now map them to the "http" helper.
  456.    • The extension now holds the default preferences, so you get default
  457.      preferences regardless of which application first uses IC.
  458.    • The extension now sanity checks preference files before opening them.
  459.      It also keeps a copy of the most recent preferences in the data fork of
  460.      the preference file, so it can revert to that backup. If that fails, it
  461.      reverts to default preferences.
  462.    • You can now copy the IC FAQ URL out of the about box. This feature lets
  463.      me answer IC support mail quicker.
  464.    • Removed "Internet Config RandomSignature" from the distribution --
  465.      while the old version should still work, I don't have time to update
  466.      and test it for this release.
  467.    • Removed "Eudora GURL Handler" from the distribution. The latest version
  468.      of Eudora has support for GURL AppleEvents.
  469.    • Updated and extended the File Mappings database.
  470.    • Pasting into password text fields now works.
  471.    • Fixed a memory leak in the extension when you open a URL with the
  472.      helper application not already running.
  473.    • Fixed a tiny memory leak in the extension when you delete a preference.
  474.    • Fixed a bunch of other minor bugs in the application that I found while
  475.      doing a code review. As far as I know, no one has encountered these
  476.      problems but me.
  477.    • Did extensive work on the internals of the extension and the
  478.      application, cleaning up and commenting the code in preparation for
  479.      large functional changes in the future. Removed Think Pascal from the
  480.      build system.
  481.    • IC 1.3 broke System 6 support but IC 1.4 again supports it.
  482.  
  483. IC 1.3 (Aug 1996)
  484.  
  485.    • Fixed a bug where the File Transfer would crash if the preference file
  486.      wasn't originally created by the Internet Config application.
  487.    • Added the Firewalls window. These preferences are used by Cyberdog and
  488.      Fetch, and will hopefully be adopted by many other applications.
  489.    • Added the World Wide Web window. Although it has very few preferences
  490.      at the moment, I expect that to change soon.
  491.    • Added mail notification preferences to the Email window.
  492.    • Improved the error display code.
  493.    • Improved the URL parsing code. IC (and any application that uses it to
  494.      parse URLs) will now recognise URLs surrounded by parentheses, square
  495.      brackets, and quotes.
  496.  
  497. IC 1.2 (Dec 1995)
  498.  
  499.  
  500.    • Added the sort and default buttons in the File Mappings window.
  501.    • Made the about box hot.
  502.    • Switched the documentation to HTML format.
  503.    • Added a bunch of new API routines to support Cyberdog, and any other
  504.      application that wants to act like the Internet Config application.
  505.    • Added the ICFindPrefHandle routine, which supplants ICGetPrefHandle and
  506.      provides better semantics.
  507.  
  508. IC 1.1 (May 1995)
  509.  
  510.    • This version was released to correct a number of minor problems with
  511.      1.0, including the System 6 support and the popup menu CDEF crashing
  512.      with lots of fonts installed.
  513.    • Added the List Font preference.
  514.    • Shipped with ICeTEe and Internet Config RandomSignature in the Goodies
  515.      folder.
  516.    • Added API routines to support parsing and launching URLs.
  517.    • Added API routines to support the file type mapping preference.
  518.  
  519. IC 1.0 (Dec 1994)
  520.  
  521.    • The first released version.
  522.  
  523.  
  524.     ------------------------------------------------------------------------
  525.  
  526.  
  527.           License and Disclaimer
  528.  
  529.  
  530. This document is Public Domain (really, we mean it!). No Rights Reserved
  531.  
  532. Comments: <ic@stairways.com>
  533.  
  534.